home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / The World of Computer Software.iso / xmetr164.zip / XMETER.DOC < prev    next >
Text File  |  1992-12-28  |  7KB  |  205 lines
  1.     
  2.     Computer Tyme XMETER * Version 1.64 * Release Date: 11-28-92
  3.     Copyright 1990-92 by Marc Perkel * All Rights Reserved
  4.     
  5.     Computer Tyme * 411 North Sherman, Suite 300 * Springfield Mo. 65802
  6.     Voice: 417-866-1222 * Modem: 417-866-1665 * Fax: 417-866-0135 * USA
  7.      
  8.     This program is part of a utilities package. Before registering it
  9.     you might want to try out some of the other programs in the package.
  10.      
  11.     You can download these other programs from our BBS at 417-866-1665 or
  12.     from our section on Compuserve. (GO COMPTYME) If you have any questions
  13.     feel free to call us.
  14.      
  15.          ┌─────────────────────────────────────────────────────┐
  16.          │ Evaluation Version. This program is not registered. │
  17.          │    If you want to use it you need to buy a copy.    │
  18.          └─────────────────────────────────────────────────────┘
  19.      
  20.     Price: $95/Server, $995/Unlimited
  21.     
  22.     XMETER is a software metering program for Novell Networks. Its simple,
  23.     uses NO RAM, and does no require any VAPs or NLMs running on the server.
  24.     
  25.     XMETER uses Novells semaphores to monitor program usage. What you do is
  26.     create a BATCH file to load your software. You open a semaphore on the
  27.     way in and close it on the way out. The batch file must be programmed to
  28.     restrict access to the program. XMETER returns dos errorlevel codes to
  29.     control batch files.
  30.     
  31.     Usage: XMETER <Semaphore> <MaxUsers> /O/C/U/L/E/F
  32.     
  33.     Semaphore is any name you want to give a semaphore.
  34.     MaxUsers is the maximum number of users allowed to use the
  35.     semaphore or the name of a meter list file.
  36.     
  37.     /O Open semaphore.
  38.     /C Close semaphore.
  39.     /U Returns number of semaphore users.
  40.     /L Outputs status line for log file redirection.
  41.     /E Returns number of semaphore users as an error level.
  42.     /F:Name specifies log file name.
  43.     
  44.     A list file can be used to specify the maximum number of users
  45.     for each program. This list file contains lines as follows:
  46.     
  47.     WORDSTAR 10
  48.     LOTUS 5
  49.     DBASE 6
  50.     
  51.     Example: XMETER TEST 10 /O   
  52.       This opens semaphore TEST if less than 10 users have it open,
  53.       otherwise to returns DOS ErrorLevel 1.
  54.     
  55.     Example: XMETER TEST /C
  56.       This closes semaphore TEST allowing others to use it.
  57.     
  58.     Example: XMETER TEST METER.LST /O/L/F:USAGE.LOG
  59.       This opens semaphore TEST if less than the number of users
  60.       specified in METER.LST have it open, otherwise to returns
  61.       DOS ErrorLevel 1. Log information is appended to log file
  62.       named USAGE.LOG.
  63.     
  64.     Example BATCH file for WordStar limited to 12 users:
  65.     
  66.     @Echo Off
  67.     XMETER WORDSTAR 10 /O
  68.     if ErrorLevel 1 goto deny
  69.     
  70.     cd\wordstar
  71.     ws
  72.     
  73.     rem Close Semaphore when done.
  74.     
  75.     XMETER WORDSTAR /C
  76.     goto e
  77.     
  78.     :deny
  79.     cls
  80.     Echo Access Denied! All copies of WORDSTAR are in use.
  81.     
  82.     rem Exit Here
  83.     :e
  84.     
  85.     Using a meter list file:
  86.     ------------------------
  87.     XMETER can use a special text file to limit semaphore access. To use
  88.     this method, substitute the name of the list file for the MaxUsers
  89.     parameter as follows:
  90.     
  91.     XMETER Lotus METER.LST /O
  92.     
  93.     METER.LST
  94.     
  95.     Lotus 10
  96.     Wordstar 15
  97.     dBase 9
  98.     
  99.     This allows you to maintain the number of copies of each program in
  100.     a single list.
  101.     
  102.     
  103.     Usage Tracking:
  104.     ---------------
  105.     
  106.     XMETER provides usage tracking by outputing a comma delimited ascii line
  107.     for each semaphore open and close. You must select the /L switch to
  108.     activate this feature.
  109.     
  110.     Example: XMETER TEST METER.LST /O/L/F:USAGE.LOG
  111.     
  112.     This command appends the following line to the file USAGE.LOG.
  113.     
  114.     "MARC","254:41","2","LOTUS","1","O","Y","08-26-90","17:43:22"
  115.     
  116.     The line contains 9 fields as follows:
  117.     
  118.     1) User Name
  119.     2) Semaphore Name
  120.     3) Number of Semaphore users after execution
  121.     4) Command, O=Open C=Close
  122.     5) Success Status, Y=Success N=Failure
  123.     6) Date
  124.     7) Time
  125.     8) Internet Address of WorkStation
  126.     9) Logical Connection Number
  127.     
  128.     Tricks:
  129.     -------
  130.     When XMETER creates semaphores, it adds the letters XM- to the front of
  131.     the semaphore name. So semaphore TEST is really XM-TEST. The idea here
  132.     is so that all XMETER semaphores can be indetified from other Netware
  133.     semaphores.
  134.     
  135.     Whenever a workstation first uses XMETER it creates a semaphore named
  136.     XM-XMETER. This can be used to see how many users are using XMETER
  137.     software. This semaphore can be cleared by using the command:
  138.     
  139.     XMETER XMETER/C
  140.     
  141.     If a user turns off their computer while running an application, Novell
  142.     will release their semaphores after 15 minutes. All semaphores are also
  143.     released when the user logs out. If a user reboots within 15 minutes,
  144.     the semaphores are cleared upon login.
  145.     
  146.     This software package is not the best program out there. It is designed
  147.     around being a simple "just works" solution to software metering. It is
  148.     flexable and uses no memory on the workstation.
  149.     
  150.     For more sophisticated software metering use MarxMenu.
  151.     
  152.     ==========================================================
  153.  
  154.         Make Check             Computer Tyme               Order Form
  155.         Payable To:     411 North Sherman Suite 300
  156.                          Springfield Mo. 65802 USA
  157.  
  158.                Voice: (417) 866-1222 * Sales: (800) 548-5353
  159.                  Fax: (417) 866-0135 * BBS: (417) 866-1665
  160.                Compuserve: 71333,427 * GO COMPTYME
  161.  
  162.         =============================================================
  163.  
  164.         Company:     ________________________________________________
  165.  
  166.         Name:        ________________________________________________
  167.  
  168.         Address:     ________________________________________________
  169.  
  170.         City/St/Zip: ________________________________________________
  171.  
  172.         Phone:       ________________________________________________
  173.  
  174.         PO. Number:  ________________________________________________
  175.  
  176.         Got From:    ________________________________________________
  177.  
  178.         Comments:    ________________________________________________
  179.  
  180.         Comments:    ________________________________________________
  181.  
  182.  
  183.         ==> XMETER * Version 1.64 * Release Date: 11-28-92
  184.  
  185.         ==> Price: $95/Server, $995/Unlimited
  186.  
  187.  
  188.         Dos ToolBox: $59.95/User __    MarxMenu: $59.95/User __
  189.  
  190.         Network Survival Kit: (Inc. ToolBox/MarxMenu) $495/Server __
  191.  
  192.         Shipping:     Ground: $3 __    2nd Day:  $6 __
  193.  
  194.                       1 Day: $15 __    Foreign: $15 __
  195.  
  196.         Credit Card Number: _______________ Expiration Date: ________
  197.  
  198.         Signature: __________________________________________________
  199.  
  200.                   Master Card: __   Visa: __   Discover: __
  201.  
  202.                     * We do not take American Express *
  203.  
  204.         =============================================================
  205.